home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / keyb / keyf_12.zip / KEYFEED.DOC < prev    next >
Text File  |  1992-04-21  |  11KB  |  245 lines
  1.  
  2.                  ┌────────────────────────────────────────────┐
  3.                  │            KeyFeed   version 1.2           │
  4.                  ├────────────────────────────────────────────┤
  5.                  │                                            │
  6.                  │                  From                      │
  7.                  │                                            │
  8.                  │         Advanced Software Engineering      │
  9.                  │                                            │
  10.                  │              Einar T. Storsul              │
  11.                  │                                            │
  12.                  └────────────────────────────────────────────┘
  13.  
  14.  
  15.    Please read this document and save yourself from a lot of trouble !
  16.  
  17.  
  18.    =======================================================================
  19.                           PROGRAM DESCRIPTION
  20.    =======================================================================
  21.  
  22.    Are you tired of writing the same keysequences within an application or
  23.    in DOS over and over again ??
  24.  
  25.    KeyFeed if a memory-resident "KEYstroke FEEDer utility" for MS-DOS which
  26.    allows you to define a serie of keystrokes that is to bee pushed to the
  27.    keyboard when you press a pre-defined key.
  28.    Keyfeed allows you to execute AND define sequences no mather wich
  29.    application you are currently running (with some exceptions, see the
  30.    technical information section of this document).
  31.  
  32.    KeyFeed works with the functionkeys (F1-F12), specialkeys (Home, End,
  33.    PgUp,PgDn ..), keycombinations (<CTRL>+<PgUp>, <ALT>+H .....) and
  34.    of course with the normal keys.
  35.  
  36.    As an illustration:  Let's say you are programming in Borland IDE, and
  37.                         while you are doing so you regulary switch
  38.                         between 23 and 45-lines display.
  39.                         Normally ou would have to push at least 5 keys
  40.                         each time.
  41.                         With KeyFeed this can bee done with one keystroke.
  42.  
  43.                         You just tell KeyFeed that when you are pressing a
  44.                         desired key, KeyFeed should "press" <ALT+O> , E, P,
  45.                         <DOWN ARROW> and <RETURN>.
  46.  
  47.    =======================================================================
  48.                           PROGRAM EXECUTION
  49.    =======================================================================
  50.  
  51.    Before you start KeyFeed make sure that you have more then 10 Kb. free RAM.
  52.    After starting KeyFeed at the DOS-prompt with c:\>KEYFEED <macro filename>
  53.    the program asks you for what keys to define.
  54.    Default <macro filename> is KEYFEED.DAT.
  55.    (The prefered method to load KeyFeed is in your autoexec.bat file, BEFORE
  56.     any other application you intend to use together with KeyFeed)
  57.  
  58.    To define <L-SHIFT>+<CTRL>+F10 you press F10, that is : you just press the
  59.    last key of the 3-key combination.
  60.    Remember : the keycombination always start with <Left Shift> + <Control>
  61.  
  62.    Now you are ready to define the keystrokes.
  63.    At startup the keystrokes previously saved in <macro filename> is
  64.    loaded to the keys.
  65.    To define a new serie of keystrokes press <L-Shift>+<ALT>+another key
  66.    (that is : while pressing and holding down the left shift and the left alt
  67.    key, push the key you want to define) or run the KeyDef program.
  68.    If you use KeyDef you must restart KeyFeed (see below).
  69.  
  70.    In the free version of the program you may only define 3 keys.
  71.  
  72.    Whatever keys you now are pressing will be loaded into KeyFeed.
  73.    This includes any type of keycombinations (such as functionkeys,
  74.    specialkeys ..).
  75.    The free version of the program prevents you from defining longer
  76.    sequences then 24 keystrokes (function keys count as one keystroke).
  77.  
  78.    The characters you are pressing will NOT BE DISPLAYED ON THE SCREEN,
  79.    this because keystrokes also may bee defined while you are inside an
  80.    application that uses a graphical display.
  81.    To terminate the sequence press "+" at the numeric keypad. Remember that
  82.    it has to be the + key at the NUMERIC KEYPAD (not the one on the
  83.    ordinary keyboard).
  84.    You may now use the defined key. Just press <L-Shift>+<CTRL>+defined key.
  85.  
  86.    You may do so wherever you are on the PC-system : inside an editor,
  87.    wordprocessor or another application.
  88.  
  89.    The only condition (see technical information !!) is that the
  90.    application must not use the key-sequence for its own purposes.
  91.    If it do so, strange things may happen, and I don't want to be held
  92.    responsible if dataloss turns out to be the result!.
  93.    (Theoreticaly KeyFeed should work with these programs too because the
  94.    predefined keysequence is NOT passed to the keyboard interrupt, but I am a
  95.    true fan of Murphy's first law : "Anything that can go wrong, goes wrong").
  96.  
  97.    If you are trying to start KeyFeed twice you'll get the message :
  98.  
  99.                "Do you want to load macros from <filename> (Y/N) "
  100.  
  101.     if you now press y or Y you'll see :
  102.  
  103.                "Loading macros from <filename>"
  104.                "Keyfeed already active, aborting..".
  105.  
  106.    otherwise you just get :
  107.  
  108.                "Keyfeed already active, aborting..".
  109.  
  110.    What the first message actually says, is that the program isn't
  111.    loading twice, but the macros saved in <filename> loads to the keys.
  112.  
  113.  
  114.  
  115.    =======================================================================
  116.                           MOUSE OPERATION
  117.    =======================================================================
  118.  
  119.    If you have a Microsoft-compatible mouse you'll see that the cursor is
  120.    activated when starting KeyFeed. This allows you to just point at a
  121.    word on the screen and klick with the left mouse button while pressing
  122.    and holding down the <Left Shift> + <Control> keys, and the word is passed
  123.    to the keyboard. (A word is defined as a collection of letters, numbers
  124.    or any other ASCII-characters separated in both ends with spaces).
  125.    Let's say you are in an editor and you want to insert a time stamp from
  126.    a clock that is running on the screen, you just "press, point and shoot".
  127.  
  128.    If the application you are running is using a mouse, it might take over
  129.    the mouse without returning control when finnished. If this happens,
  130.    press <Left Shift>+<Control>+<Numeric +> to reactivate the mouse.
  131.  
  132.    This function only works if the monitor is in text-mode (not in graphics)
  133.    I don't know how useful this option is, but anyhow : here it is.
  134.  
  135.  
  136.    =======================================================================
  137.                           The KeyDef program
  138.    =======================================================================
  139.  
  140.    First of all : DON'T TRY TO PLAY A MACRO FROM KEYFEED INSIDE KEYDEF !
  141.  
  142.    KeyDef is a program that lets you define AND SAVE macros. The keystrokes
  143.    is saved in a file called KEYFEED.DAT by default, but you may use
  144.    another filename by writiting C:\>KEYDEF <filename> , where <filename>
  145.    is the name of the file where the macros is to bee saved.
  146.    The number of macrofiles to use is unlimited.
  147.  
  148.    The use is very simple : after startng the program you just press the
  149.    keystrokes you want KeyFeed to use.
  150.    To terminate a sequence press "+" at the numeric keypad.
  151.    If you press "+" as THE FIRST KEY, the keys already defined (AND SAVED)
  152.    will not be changed.
  153.    After pressing "+" in the last sequence (no. 3) the macro is automaticaly
  154.    saved.
  155.  
  156.    =======================================================================
  157.                           TECHNICAL INFORMATION
  158.    =======================================================================
  159.  
  160.    KeyFeed requires an IBM-compatibel PC with MS-DOS version 3.30+, it has
  161.    been tested with versions from 3.30 up to 5.0. It also requires about 10 Kb.
  162.    of free RAM and an enchanged keyboard (101-keys).
  163.    To use the KeyDef program you also need a color display adapter and a
  164.    color monitor.
  165.  
  166.    KeyFeed hooks on to the keyboard interrupt (INT 9h) and checks for